跳到主要内容

使用 Notion API 创建集成

使用 Notion API 创建集成 - 主图

通过 Notion 的 API，您可以创建自定义的内部集成。一些合作伙伴可能还需要一个内部集成令牌，以便将他们的平台与您的 Notion 工作区连接起来 - 在下面，我们将为您介绍如何设置这个令牌 🏗️​

目录

  • 创建一个内部集成
  • 创建一个公共集成
  • 细粒度的集成权限 请访问我们的开发者中心获取文档、资源和集成管理工具。

创建内部集成​

  • 在左侧边栏中，导航到设置与成员，然后选择集成选项卡。

  • 只有工作区所有者才能访问集成选项卡并创建集成。如果您不是管理员，请联系您的工作区管理员或使用其他工作区。

  • 点击底部的 Develop your own integrations（开发自己的集成） 链接。

  • 我的集成 将在默认浏览器中打开。点击 + 新建集成功能（New integration） 按钮。

我的集成功能（My integrations）

注意： 确保您在网页会话上登录了与桌面相同账户。否则，您将无法看到正确的账户和工作区！

  • 为您的集成功能提供一个 名称（Name） 。可选择性地，您还可以上传一张图片作为 标志（Logo）。

  • 使用下拉菜单指定您想要将此集成与哪个 关联工作区（Associated workspace） 一起使用。

集成信息（Integration info）

**注意：**内部集成是特定于工作区的，因此要更改关联的工作区，您需要创建一个新的集成。

  • 您的内部集成已成功添加！现在您可以在工作区中看到它，在 设置和成员 菜单 → 我的集成 中。

Integration menu - create

  • 单击内部集成旁边的 ••• 以检索内部集成令牌。您将需要此令牌用于团队创建任何基于 API 的自动化或工作流程，或者将您的工作区链接到某些合作伙伴平台。

创建公共集成​

所有新增加的集成最初都是内部使用。如果你是开发人员正在开发一个公共集成，请首先按照上述说明创建一个内部集成功能。

然后，请按照我们开发人员指南中的说明将其转换为公共集成功能。

细粒度的整合权限​

在应用程序设置过程中，开发人员将能够选择所需的用户访问级别。

  • 内容功能：

  • 仅读取内容

  • 仅写入内容

  • 插入内容

  • 用户权限

  • 无用户信息

    • 读取用户信息（不包括用户的电子邮件地址）

    • 读取用户信息（包括电子邮件）

当用户安装集成时，将显示此访问级别。它还会显示在已添加该集成的任何页面的“共享”菜单中。了解更多关于在工作区中安装集成 →